文档

接入iOS应用

更新时间:

ARMS用户体验监控的App监控提供了非常全面的移动端应用监控能力,主要包括iOS应用监控和Android应用监控。本文介绍如何将iOS应用接入ARMS用户体验监控

步骤一:创建应用

  1. 登录ARMS控制台

  2. 在左侧导航栏选择用户体验监控 > 应用列表,并在顶部菜单栏选择目标地域。

  3. 应用列表页面单击添加应用

  4. 创建应用面板单击iOS

  5. iOS面板输入应用名称和描述,然后单击创建

    说明

    应用名称唯一,不能与已创建的应用名称重复。

    创建成功后,当前应用将会自动生成对应的ConfigAddress(上报地址)和AppID。

步骤二:集成SDK

Cocoapods自动集成(推荐)

  1. 在Xcode工程的Podfile文件中添加最新版本SDK。

    source 'https://github.com/CocoaPods/Specs.git'
    
    target 'iOSDemo' do
      # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
      use_frameworks!
    
      # 导入阿里云 ARMS RUM SDK
      pod 'AlibabaCloudRUM', '0.3.3'
    end
  2. 在项目根目录下(或Podfile文件所在目录)执行以下命令更新Pod环境。

    pod install --repo-update

手动集成

  1. 下载SDK并解压。

    解压.zip文件后得到如下内容:

    • AlibabaCloudRUM.xcframework

    • OpenBusiness.xcframework

    • OpenCore.xcframework

    • OpenRUM.xcframework

    image

  2. 配置工程。

    1. 通过Xcode打开File > Add Files to "Your Project Name"...,在弹出的面板中选择需要下载的组件包,然后单击Add

      说明

      建议选中Copy items if needed

      image

    2. 在项目设置target > Build Phases > Link Binary With Libraries中添加如下依赖库。

      • libc++.tbd(必须引入)

      • libresolv.tbd(必须引入)

      image

    3. target > Build Settings中搜索Ohter Linker Flags,添加编译标志-ObjC

      重要

      请注意检查-ObjC的拼写。

      image

步骤三:导入头文件

在main.m或AppDelegate.m中导入头文件。

Objective-C

@import AlibabaCloudRUM;

Swift

import AlibabaCloudRUM

步骤四:初始化

main函数或- application:didFinishLaunchingWithOptions:方法中完成SDK的初始化。

Objective-C

[AlibabaCloudRUM setConfigAddress:@"<your config address>"];// ConfigAddress,步骤一创建RUM应用时获取。
[AlibabaCloudRUM startWithAppID:@"<your appId>"];// AppID,步骤一创建RUM应用时获取。

Swift

AlibabaCloudRUM.setConfigAddress("<your config address>")// ConfigAddress,步骤一创建RUM应用时获取。
AlibabaCloudRUM.start("<your appId>")// AppID,步骤一创建RUM应用时获取。

接入验证

应用运行后,返回SDK Config Succeeded即表示SDK初始化成功。

返回示例:

2024-04-23 16:07:18.450 [OpenRUM] [CONFIG]  SDK Config Succeeded.